This documentation is auto-produced by a 4D method.
Each method is separated by 90 asterisks (*)
Documentation Date: 2011-11-10T00:00:00 14:45:37
DisplayList4D Version: number: 404, date: 2011-10-27T00:00:00
© 2001-2011 BBI. All rights reserved.

******************************************************************************************
*DL_AppendColumn*
DL_AppendColumn(->Array;HeaderText;ColWidth;{MiscPrm1-n})
By: Tony Ringsmuth, 03/12/11, 12:07:42

FUNCTION: 
An API to configure a DisplayList, one entire column, including all of it's characteristics, at a time:
  - Array
   - Header
   - Width
   - Format
   - Font/Style/Alignment, etc.
--------------------------------------------------------------------------------
PARAMETERS
$1:Pointer;  -> Array
$2: Text: header text
$3: Longint: Column Width.   Pass -2 to set column to Hidden
${4-N}: Text:   {Name;Value}
   Names Include: 
      ColJust   (or "Justify")
      Font
      FontSize
      FontStyle
      Format or Fmt
      HdrFont
      HdrFontSize
      HdrFontStyle
      HdrJust{ify}  or HdrAlign{ment}  :  Values: Left, Center, Right, or #
      Hidden or H
      Visible or V
--------------------------------------------------------------------------------
EXAMPLE
DL_AppendColumn (->$aName;"Name";100)
DL_AppendColumn (->$aDOB;"DOB";70;"Fmt;7")
DL_AppendColumn (->$aAge;"Age";50;"HdrJust;Left";"HdrFontSize;30")
DL_AppendColumn (->$aRow;"Row";100;"Format;####,HdrJust;1,Font;Arial")
DL_AppendColumn (->$aRow2;"Row2";100;"HdrJust;right")
DL_AppendColumn (->$aTime;"Time";75;"Format;"+Char(HH MM AM PM))
$iRowSelect:=DL_DisplayList
--------------------------------------------------------------------------------
REVISION HISTORY
03/12/11: New

******************************************************************************************
*DL_Defaults*
DL_Defaults({Opts};{Reserved};{Width};{FontSize};{SortColumn};{HideColumnCnt})

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION:
Give the developer one mehtod that can set many of the common elements
  of DisplayList4D, all in one call.
Also, Define a default behavior of the list that different than the standard
   default.

STANDARD DEFAULTS SET BY THIS METHOD:
Set List and Headers size to 10 point plain
Set light grey dividers for columns and rows

--------------------------------------------------------------------------------
PARAMETERS
$1: Integer: Bitwise Options Parameter:
    Hide Last Column: (0) +1  (Replace this with vDL_HideColumnCnt)
    Multi-Lines: (1) +2
    NO Pre-Sort Ascending: (2) +4
    No User Sorting: (3) +8
    PreSort Descending: (4) +16
    Prevent Column Resize: (5) +32
    Display Pixel Widths: (6) +64
    Use Current 4D Window: (7) +128
$2: Longint: Reserved
$3: Window Width
$4: Font Size
$5: Sort column Number
$6: Number of columns to hide

--------------------------------------------------------------------------------
EXAMPLE:
See example in DisplayList4D
--------------------------------------------------------------------------------
REVISION HISTORY 
Rev: 11/23/02: Reversed Bit 2 of Opts Param
Rev: 09/16/02

******************************************************************************************
*DL_DisplayList*
DL_DisplayList(TextOpts;->Arrays-n)
Tony Ringsmuth  7/23/02

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com
--------------------------------------------------------------------------------
PERSONAL NOTE (by Tony Ringsmuth):
God so loved the world that he gave his son, Jesus, so that whoever would believe in him would not die, but would have eterenal life.  (John 3:16, paraphrased)
Salvation is found in no one else, for there is no other name under heaven given to men by which we must be saved. (Acts 4:12)
Each man may choose the way that seems right to himself.  However, one day each man will stand before God to answer for those choices.  God offers restoration to himself only through Jesus Christ. Choose life. (Tony Ringsmuth)
--------------------------------------------------------------------------------
FUNCTION
The main call to trigger the DisplayList.
Do all configuration of the list prior to this call.

--------------------------------------------------------------------------------
PARAMETERS
$0: Longint: Reserved
$1: TextOptions: delimited by semi-colon, and commas:
Note: Any configuration that is passed here in TextOpts supersedes configuration via previous command calls.

          Name: "HorizontalScrollbarVisible"
          Value: {False values = (0@ | F@ | N@):  Default is Visible

          Name: "ListFontName" / "ListFontSize" / "ListFontStyle"
          Value: FontName / FontSize / FontStyle
                    Over-rides DL_SetListHdrStyle

          Name: "RowHeight"
          Value: {NumericValue}
                    Sets the row height (in Pixels) of the list area.

          Name: "RestoreSortOrder"
          Value: {no value}:
                    With this option selected, If passed, then if the arrays in the displayList get sorted, DisplayList will restore them to their original sort order when exiting.

          Name: "RowHeight"
          Value: {Row Height in Pixels}

          Name: "SelectedRowHighlightColorInFilterMode"
          Value: {an RGB Number value, expressed in either a decimal number, or #.#.#}:
                    If you want to change the font color for highlighted rows, specify the rgb value here.

          Name: "ShowFilter"
          Value: {no value: pass the tag only}

          Name: "FilterValue"
          Value: Pass the desired filter value.  You can pass embedded commas using "<comma>"

          Name: "SingleClickAccept"
          Value: 0 or 1:

          Name: "StickySelect"
          Value: 0 or 1
                    This is only valid in the context of multi-row-select, and (SingleClickAccept = 0).
                    If set to 1, then the user can single-click rows to select, and must re-click a row to de-select it.
                    Rows do NOT de-select because the user selects another row.

          Name: "Title"
          Value: List Title Text

          Name: "TitleFont"
          Value: Name of font for ListTitle

          Name: "TitleFontSize"
          Value: Size of font for ListTitle

          Name: "TitleFontStyle"
          Value: Size of font for ListTitle

          Name: "VerticalScrollbarVisible"
          Value: {False values = (0@ | F@ | N@):  Default is Visible

          Name: "WinType"
          Value: {window type number}

          Name: "WinPadHeight"
          Value: {NumericValue}
                    If no Window height is specified for the DisplayList Window, and we are auto-calculating, you can force some additional Pad Height (in Pixels) here.

          Name: "WinCenter"
          Value: "FrontmostWindow"  Center the list window to the frontmost 4D Window
          Value: "Screen"  Center the list window to the screen (or 4D MDI Window) center

$2-N: Pointers to Arrays.

--------------------------------------------------------------------------------

EXAMPLE 1: 
DL_SetListHeaders("Data Merge Expressions...";" Allow Room For...";"Example")
DL_SetListHdrStyle("Arial";12;0)
DL_SetListStyle("Arial";12)
DL_SetListButtons("Insert";"Cancel";"Please select an expression:";"Other...")  `Set a 3rd button as "Other..."
DL_SetListWidths(120;80;180)
DL_SetListBehavior(0;0;0;0;0;0;0)
DL_SetListColor("Black";0;"White";0)
DL_SetListSize(600;400;0)
DL_SetListHdrColor("Red";0;"Light Gray";0)
DL_SetListLine(vMergeLine)
DL_SetListBackgroundPicture($MyPict)
DL_Defaults(8+16;Size of array(aMerge_Name))  `No User Sorting, PreSort Descending

$TxtOpts:=""
$TxtOpts:=$TxtOpts+"RowHeight;18,"  `Set row height to 18
$TxtOpts:=$TxtOpts+"WinType;8,"  `  set window type to 8
$TxtOpts:=$TxtOpts+"ShowFilter,"  `Enables a clairvoyance filter that tha user can type into.
$TxtOpts:=$TxtOpts+"SelectedRowHighlightColorInFilterMode;"+String(0x00316AC5)+","

$ItemNumSelect:=DL_DisplayList($TxtOpts;->aMerge_Name;->aMerge_MaxLng;->aMerge_Example)
$iBtnNum:=DL_GetListButton  `Get the button number that the user clicked (OK=1, Cancel=2, other buttons = 3-N)
$BtnText:=DL_GetListButtonNameClicked   `Get the text of the button that the user clicked
If ($iBtnNum=3)
  `Do something for "Other..."
End if 
DL_SetListDone   `: Clear any remaining memory (clean up variables)

EXAMPLE 2: 
For this example, see also: DL_AppendColumn
DL_SetListBackgroundPicture ($MyPict)
DL_SetListButtons ("OK";"cancel";"MyTitle";"MyBtn3";"T";"Stop";"S";"-";"";"five";"5")
DL_AppendColumn (->$aPerson_Name;"Name";100)
DL_AppendColumn (->$aPerson_BirthDate;"DOB";70;"Fmt;7")
DL_AppendColumn (->$aPerson_Age;"Age";50;"HdrJust;Left";"HdrFontSize;30")
DL_AppendColumn (->$aPerson_Height;"Height";100;"Format;####,HdrJust;1,Font;Arial")
DL_AppendColumn (->$aPerson_IQ;"IQ";100;"HdrJust;right";"ColFont;Arial;14;1")  `Column font of Arial 14pt bold
DL_AppendColumn (->$aPerson_ID;"ID";-2;"HdrJust;right")  `with of -2 = Hidden Column
$i:=DL_DisplayList ("Title;NewTitle,TitleFont;Geneva,TitleFontSize;24,TitleFontStyle;1")
$BtnName:=DL_GetListButtonNameClicked 

--------------------------------------------------------------------------------
REVISION HISTORY
03/17/11: Added TextOpts for configration (text, font, style, size) of list Title
01/25/2011: Added the "StickySelect" option
06/19/2010: Added the "FilterValue;{Value}" text option
04/28/2010: Added the "SingleClickAccept" option
02/16/2010: Debug the SelectedRowHighlightColorInFilterMode feature
01/27/2010: Major upgrade: code for V11, and enable Filtering
11/10/2009: Improvements to "RestoreSortOrder" option
11/07/2009: Fixed bugs for V11.  Enable passing of 2D and Local arrays
 08/14/2002: Added ARRAY INTEGER(aDL_Select;0)
 08/09/2002: changed vDL_Widths to aDL_Widths

******************************************************************************************
*DL_GetArrays*
DL_GetArrays(->PointerArray)
By: Tony Ringsmuth, 05/11/11, 17:05:03

FUNCTION: Read back the list of Arrays that was configured for the list
 
--------------------------------------------------------------------------------
PARAMETERS

--------------------------------------------------------------------------------
REVISION HISTORY
05/11/11: New

******************************************************************************************
*DL_GetButtonNameClicked*
DL_GetButtonNameClicked -> Text of the button clicked by the user.
By: Tony Ringsmuth
--------------------------------------------------------------------------------
FUNCTION

--------------------------------------------------------------------------------
PARAMETERS
$0: Return the button name clicked by the user.
If user clicks the close-window button, $0 will return the button text for the {Cancel} button (whatever it's name was)
A double-click will be reported as the text of the OK button (Button 1)
--------------------------------------------------------------------------------
REVISION HISTORY
01/27/10, 12:45:37: New
--------------------------------------------------------------------------------
EXAMPLE:
$BtnText:=GetListButtonNameClicked

******************************************************************************************
*DL_GetButtonNumberClicked*
DL_GetButtonNumberClicked->Selected Button Number

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

See Also: SetListButtons4D

--------------------------------------------------------------------------------
FUNCTION
Return the selected button number that the user activated.

--------------------------------------------------------------------------------
PARAMETERS
$0: Longint
    OK button = 1
    Cancel button = 2
    Button3 = 3, etc
--------------------------------------------------------------------------------
REVISION HISTORY

--------------------------------------------------------------------------------
EXAMPLE:
See example in DisplayList4D

******************************************************************************************
*DL_GetInDisplayList*
DL_GetInDisplayList ->Boolean

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Return true if the user is already in a DisplayList area.
This is a Protection method. 
If an AreaList area calls a display list method via an AreaList Callback, often, the display list will get called twice.
This protects against that.

--------------------------------------------------------------------------------
EXAMPLES

If (DL_InDisplayList )
   `Do Nothing: Prevent a double call
Else 
   $iResult:=DisplayList4D (0;->aName;aPhone)
End if 

--------------------------------------------------------------------------------
PARAMETERS
$0: Boolean: Return True if we are in a Display List Area
--------------------------------------------------------------------------------
REVISION HISTORY 

******************************************************************************************
*DL_GetListFormat*
DL_GetListFormat({ColumnNumber})->Format(s)
By: Tony Ringsmuth, 05/12/11, 07:14:48

FUNCTION: 
 Return a column format, or all Formats
--------------------------------------------------------------------------------
PARAMETERS
$0: Text: the formats
$1: Longint, optional:  Column number.
      If $1 is not passed, then all formats (delimited by Tabs) are returned in $0

--------------------------------------------------------------------------------
REVISION HISTORY
05/12/11: New

******************************************************************************************
*DL_GetListHeaders*
DL_GetListHeaders({->aTextArray}) -> Headers (tab delimited)
By: Tony Ringsmuth, 05/11/11, 22:20:53

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

FUNCTION: 
 Return the full list of headers in $0, AND in $1-> (text array, if passed)
--------------------------------------------------------------------------------
PARAMETERS
$0: Text: Headers (tab delimited)
$1: Pointer, optional: pointer to a Text Array

--------------------------------------------------------------------------------
REVISION HISTORY
05/11/11: New

******************************************************************************************
*DL_GetListSelect*
DL_GetListSelect(->NumericArray)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION:
Return an array of selected element numbers.
This is only applicable if the "MultiRows" option in SetListBehavior4D ($1 = 1) is configured

--------------------------------------------------------------------------------
PARAMETERS
$0: Longint: Returns the number of the first selected row
$1: Pointer to a numeric array, which points to all selected rows
--------------------------------------------------------------------------------
REVISION HISTORY
11/05/2008: better enable $1 to be any numeric type.

******************************************************************************************
*DL_GetListSortColNum*
DL_GetListSortColNum  -> Column Number: Longint

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com
--------------------------------------------------------------------------------
FUNCTION
Return the primary sorted column number: User sorted or sorted by original configuration.
Return a negative number if the column is sorted in descending order.

See also: GetSortColPtr

--------------------------------------------------------------------------------
PARAMETERS
$0: Longint

--------------------------------------------------------------------------------
REVISION HISTORY
08/02/10, 08:10:45: New
--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_GetListSortColPtr*
DL_GetListSortColPtr  -> Pointer

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com
--------------------------------------------------------------------------------
FUNCTION
Return a pointer to the primary sorted column array: : User sorted or sorted by original configuration.

See also: GetSortColNum
--------------------------------------------------------------------------------
PARAMETERS
$0: Pointer

--------------------------------------------------------------------------------
REVISION HISTORY
08/02/10, 08:29:54: New
--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_GetListWidth*
DL_GetListWidth(ColumnNumber)->Width

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

••• This method varies in parameters from DisplayList•••

--------------------------------------------------------------------------------
FUNCTION:
Return a column width from the DisplayList4D Area

--------------------------------------------------------------------------------
PARAMETERS
$0: Longint: Returns the column width for the specified clumn number
$1: Longint: Column Number

******************************************************************************************
*DL_GetPointer*
DL_GetPointer(VarName)->Pointer
By: Tony Ringsmuth, 03/05/09

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Get a pointer to a DisplayList variable.  This is intended for very advanced needs.
Use this at your own risk.
Probably to be used in conjunction with SetListCallback

--------------------------------------------------------------------------------
PARAMETERS
$0: Pointer
$1: Text: a valid DisplayList variable name

--------------------------------------------------------------------------------
REVISION HISTORY
03/05/2009: New

******************************************************************************************
*DL_SetListBackgroundPicture*
DL_SetListBackgroundPicture (Picture)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION:
Set a background picture to the DisplayList4D Window

--------------------------------------------------------------------------------
PARAMETERS
$1: Picture: The picture that you want to set

******************************************************************************************
*DL_SetListBehavior*
DL_SetListBehavior(MultiRows;{AllowResize};{SortColumn};{preSort};{UserSort};{DisplayPixelWidth};{HideLastColmn})

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Configure various behaviors of the DisplayList

--------------------------------------------------------------------------------
PARAMETERS
For all parameters: pass a -1 to leave the setting un-changed from the prior call.
Omitting a parameter will also leave it's setting unchanged from the prior call.

$1; Integer: MultiRows:  single or multiple-line selection (Dflt 0)
$2; Integer: AllowColumnResize user resizable columns (Dflt 1)
$3; Integer: SortColumn column for presort
         Default is the first string or text column from the left.
$4; Integer: PreSort presort off, ascending or descending (Dflt 1)
        0 = NoPresort, 1 = Presort Ascending, 2 = Presort Descending
$5; Integer: UserSort  allow user to sort  (Dflt 1)
$6; Integer: DisplayPixelWidth  display column widths (Dflt 0)
$7; Integer: HideLastColmn  don't display last array passed to DisplayList (Dflt 0
      (You can hide more than one column)

--------------------------------------------------------------------------------
REVISION HISTORY
03/03/2009: Enabled a -1 for all parameters to leave the settings unchanged

--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListButtons*
DL_SetListButtons(OKBtn;CancelBtn;Title;Btn3-n;Btn3-n Key)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION:
Set the button texts, and DisplayList4D title area

--------------------------------------------------------------------------------
PARAMETERS
 For all parameters: pass "=" to leave the prm unchanged from prior call

$1: Text: OK Button text.  Pass "-" to remove the OK button
$2: Text: Cancel Button Text.  Pass "-" to remove the Cancel Button
$3: Text: The header title in the DisplayList4D window
$4: Text: (optional) Button3 text
$5: String: (optional) the command-key to activate button 3
$6: Text: (optional) Button3 text
$7: String: (optional) the command-key to activate button 4
$8: Text: (optional) Button4 text
$9: String: (optional) the command-key to activate button 5
$10: Text: (optional) Button5 text

--------------------------------------------------------------------------------
REVISION HISTORY
03/20/2009: Bug fix: line 87
03/03/2009: For all parameters: pass "=" to leave the prm unchanged from prior call

--------------------------------------------------------------------------------
EXAMPLE:
The following two examples accomplish exactly the same thing:

SetListButtons4D ("Yes";"No";"Select the reason";"Other...";"O")

OR:

SetListButtons4D ("Yes")
SetListButtons4D ("=";"No")
SetListButtons4D ("=";"=";"Select the reason")
SetListButtons4D ("=";"=";"=";"Other...")
SetListButtons4D ("=";"=";"=";"";"O")

******************************************************************************************
*DL_SetListCallback*
DL_SetListCallback(MethodName)
By: Tony Ringsmuth, 07/24/06

--------------------------------------------------------------------------------
FUNCTION:
Set a Form Method callback
At each event of the Form Method, the callback method that you specify here will be executed once.

--------------------------------------------------------------------------------
PARAMETERS
$1: Text: method Name
 
******************************************************************************************
*DL_SetListColor*
DL_SetListColor (FontColorString;FontColorNumber;FillColorString;FillColorNumber)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Set list colors (256 colors)
To set list colors by RGB, use: SetListRGBColor4D
To set specific row colors, use SetListRowBackColorsArray4D

--------------------------------------------------------------------------------
PARAMETERS
$1: String: Font Color: values listed below
$2: Longint: Font Color: 1 to 256
           Pass -1 to leave un-changed
$3: String: Fill Color: values listed below
$4: Longint: Fill Color: 1 to 256
           Pass -1 to leave un-changed

"Gray" will also be interpreted as "Grey"

White	0
Yellow	1
Orange	2
Red	3
Purple	4
Dark Blue	5
Blue	6
Light Blue	7
Green	8
Dark Green	9
Dark Brown	10
Dark Grey	11
Light Grey	12
Brown	13
Grey	14
Black	15

--------------------------------------------------------------------------------
REVISION HISTORY
03/04/2009: re-write & enable to call from within callback

--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListDividers*
DL_SetListDividers (ColDividerPattern;ColDividerColor1;ColDividerColor2;
RowDividerPattern;RowDividerColor1;RowDividerColor2)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

Note: This method is for compatability purposes only: It's functionality is currently not supported. (03/04/2009)

--------------------------------------------------------------------------------
FUNCTION
Set the Dividers (column & row) for the list

--------------------------------------------------------------------------------
PARAMETERS
Parameter Type Description
ColDividerPattern; string ;pattern of the column divider
ColDividerColor1;  string ;color from DisplayList?s palette for the column divid
ColDividerColor2;  integer ;color from 4D?s palette for the column divider
RowDividerPattern; string ;pattern of the row divider
RowDividerColor1; string ;color from DisplayList?s palette for the row divider
RowDividerColor2; integer; color from 4D?s palette for the row divider

--------------------------------------------------------------------------------
REVISION HISTORY
03/04/2009: mods

--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListDone*
DL_SetListDone

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Clear out variables used by DisplayList4D
--------------------------------------------------------------------------------
PARAMETERS
None

--------------------------------------------------------------------------------
REVISION HISTORY
Rev: 11/23/02: Multiple changes
Rev: 09/26/02: Set Buttons to Zero
Rev: 08/09/02: aDL_Widths
--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListFormats*
DL_SetListFormats(Column;Format)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Set column formats for the list

--------------------------------------------------------------------------------
PARAMETERS
$1: Longint: Column number
$2: Text: Format string

--------------------------------------------------------------------------------
REVISION HISTORY

--------------------------------------------------------------------------------
EXAMPLE:
SetListFormats4D (1;"$###,##0.00")

******************************************************************************************
*DL_SetListHdrColor*
DL_SetListHdrColor  (FontColorString;FontColorNumber;FillColorString;FillColorNumber)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Set list header colors

--------------------------------------------------------------------------------
PARAMETERS
$1: String: Font Color: values listed below
$2: Longint: Font Color: 1 to 256
$3: String: Fill Color: values listed below
$4: Longint: Fill Color: 1 to 256

"Gray" will also be interpreted as "Grey"

White	0
Yellow	1
Orange	2
Red	3
Purple	4
Dark Blue	5
Blue	6
Light Blue	7
Green	8
Dark Green	9
Dark Brown	10
Dark Grey	11
Light Grey	12
Brown	13
Grey	14
Black	15

--------------------------------------------------------------------------------
REVISION HISTORY
03/04/2009: re-write

--------------------------------------------------------------------------------
EXAMPLE:
SetListHdrColor4D("Green";0;"Black";0)

******************************************************************************************
*DL_SetListHdrStyle*
DL_SetListHdrStyle(FontName;{Size};{StyleNumber})

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

Headers: Geneva 12 plain is default
List: Geneva 10 Plain is default

--------------------------------------------------------------------------------
FUNCTION
Set the list header styles

--------------------------------------------------------------------------------
PARAMETERS
$1: Text: Font name.  Pass "=" to leave unchanged.
$2: Integer: Font Size.  Pass zero or -1 to leave unchanged.
$3: integer: Font style number.  Pass -1 to leave unchnaged

--------------------------------------------------------------------------------
REVISION HISTORY
03/05/2009: Enable configuration form within list.

--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListHeaders*
DL_SetListHeaders(Headers1-n)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Set the list headers

--------------------------------------------------------------------------------
PARAMETERS
$1-N: Text: Header text.  ou can pass semi-colon delimited text in $1 for multiple headers.

--------------------------------------------------------------------------------
REVISION HISTORY
03/04/2009: Enable to work in a Callback

--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListLine*
DL_SetListLine(LineNumber)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Set the default selected line number for the list

--------------------------------------------------------------------------------
PARAMETERS
$1: Longint: Line number

--------------------------------------------------------------------------------
REVISION HISTORY
03/04/2009: enable from callback

--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListRGBColor*
DL_SetListRGBColor (FontRGBColor;BackGroundRGBColor;AlternateRowRGBColor)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

This command has no equivelant in displayList

--------------------------------------------------------------------------------
FUNCTION
Set colors of the list by RGB values.
To set specific row colors, use SetListRowBackColorsArray4D

--------------------------------------------------------------------------------
PARAMETERS
$1: Longint: FontRGBColor
$2: Longint: BackGroundRGBColor
$3: Longint: AlternateRowRGBColor

Pass a -1 in $1,$2 or $3 to leave the setting un-changed.

--------------------------------------------------------------------------------
REVISION HISTORY

--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListRowBackColorsArray*
DL_SetListRowBackColorsArray(->LongintArray(RGBColors) or nil)
By: Tony Ringsmuth, 12/17/09, 11:05:55

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
An API method to set a row background colors array for the DisplayList.
Pass a pointer to a longint array with the same number of elements as your displayed arrays.
To apply the default background color from the list to a row, populate a value of -255 for that element.
NOTE: These are RGB Colors

--------------------------------------------------------------------------------
PARAMETERS:
$1: Pointer to a Longint array, or nil pointer to clear the row colors array.

--------------------------------------------------------------------------------
REVISION HISTORY
12/17/09: New

******************************************************************************************
*DL_SetListRowFontColorsArray*
DL_SetListRowFontColorsArray(->LongintArray(RGBColors) or nil)
By: Tony Ringsmuth, 12/17/09, 11:05:55

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
An API method to set a row font colors array for the DisplayList.
Pass a pointer to a longint array with the same number of elements as your displayed arrays.
To apply the default color from the list to a row, populate a value of -255 for that element.
NOTE: These are RGB Colors

--------------------------------------------------------------------------------
PARAMETERS:
$1: Pointer to a Longint array, or nil pointer to clear the row colors array.

--------------------------------------------------------------------------------
REVISION HISTORY
12/17/09: New

******************************************************************************************
*DL_SetListRowHeight*
DL_SetListRowHeight(RowHeight_in_pixels)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION

--------------------------------------------------------------------------------
PARAMETERS:

--------------------------------------------------------------------------------
REVISION HISTORY
12/01/09: New

******************************************************************************************
*DL_SetListRowStylesArray*
DL_SetListRowStylesArray(->NumericArray(fontstyles) or Nil)
By: Tony Ringsmuth, 12/17/09, 11:01:46

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
An API method to set a row styles array for the DisplayList.
Pass a pointer to a longint array with the same number of elements as your displayed arrays.
To apply the default style from the list to a row, populate a value of -255 for that element.

--------------------------------------------------------------------------------
PARAMETERS:
$1: Pointer to a Longint array, or nil pointer to clear the row styles array.

--------------------------------------------------------------------------------
REVISION HISTORY
12/17/09: New

******************************************************************************************
*DL_SetListSelect*
DL_SetListSelect(->NumericArray)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Set a list of items to be highlighted
Note this can also be called from within a CallBack method to dynamically set items within a list.

--------------------------------------------------------------------------------
PARAMETERS
$1: pointer to a numeric array

--------------------------------------------------------------------------------
REVISION HISTORY
03/04/2009: enable from callback

--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListSize*
DL_SetListSize(WindowHeight;WindowWidth;{Location})

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Configure the window size for the displayed list.

--------------------------------------------------------------------------------
PARAMETERS
$1: Window Height: Pass -1 to use current 4D window
$2: Window Width: Pass -1 to use current 4D window
$3: Window Location:
     0 window centered on screen (default),
     1 window centered in top 4D window, or
     2 window at top left of screen.
--------------------------------------------------------------------------------
REVISION HISTORY

--------------------------------------------------------------------------------
EXAMPLE:
SetListSize4D (600;400)

******************************************************************************************
*DL_SetListStyle*
DL_SetListStyle(FontName;{Size};{Style})

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

Headers: Geneva 12 plain is default
List: Geneva 10 Plain is default
--------------------------------------------------------------------------------
FUNCTION
Set the list font styles

--------------------------------------------------------------------------------
PARAMETERS
$1: Text: Font name,   Pass "=" to leave unchanged
$2: Integer: Font Size,   Pass zero or -1 to leave unchanged
$3: integer: Font style number,   Pass -1 to leave unchanged

--------------------------------------------------------------------------------
REVISION HISTORY
03/05/2009: Enable to configure from callback

--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListWidths*
DL_SetListWidths(Widths1-N)

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

--------------------------------------------------------------------------------
FUNCTION
Set the list column widths

--------------------------------------------------------------------------------
PARAMETERS
$1-N: Widths
   Pass 0 to let the column go to default width
   Pass -1 on any column to leave un-touched from previous setting
   Pass -2 to make the column invisible.

--------------------------------------------------------------------------------
REVISION HISTORY
11/09/2009: Documentation update.
03/04/2009: Enabled to call from callback.

--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_SetListWidthsText*
DL_SetListWidthsText(WidthsText;{ScaleFactor})

PART OF THE DisplayList4D Component
Written by Tony Ringsmuth of Business Brothers, Inc.
BBSP.com

This method is over and above basic DisplayList Calls

--------------------------------------------------------------------------------
FUNCTION
Allow developer to set the widths of the display list by delimited text.
   Pass 0 to let the column go to default width
   Pass -1 on any column to leave un-touched from previous setting
   Pass -2 to make the column invisible.
--------------------------------------------------------------------------------
PARAMETERS

--------------------------------------------------------------------------------
REVISION HISTORY
06/19/10: -2 makes columns invisible
03/04/2009: Enabled to call from callback.

--------------------------------------------------------------------------------
EXAMPLE:
SetListWidthsText4D("50;50;25;50")

******************************************************************************************
*DL_Util_RowColors*
DL_Util_RowColors
By: Tony Ringsmuth
--------------------------------------------------------------------------------
FUNCTION
This is NOT an api method.

--------------------------------------------------------------------------------
PARAMETERS
--------------------------------------------------------------------------------
REVISION HISTORY
01/28/10, 14:37:04: New
--------------------------------------------------------------------------------
EXAMPLE:

******************************************************************************************
*DL_Version*
DL_Version({->VersionDate output})
--------------------------------------------------------------------------------
FUNCTION
This is a revision change / Version documentation method

--------------------------------------------------------------------------------
PARAMETERS:
$0: Longint: Returns the version number
$1: Pointer to a Date object: optional: Return the version date
--------------------------------------------------------------------------------
DisplayList4D is written by Tony Ringsmuth of Business Brothers Inc.
Copyright 2004 to 2007 All rights reserved
All sourcecode is property of Business Brothers Inc, and Tony Ringsmuth

******************************************************************************************